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/ CHAPTER 1 

EDIT-80 Operation 

1 . 1 Introduction 

EDIT-80 is a line-oriented and character-oriented 
text editor. EDIT-80 commands are simple and 
straightforward, yet powerful enough to accommodate 
the most demanding user. For the novice or for 
those requiring only cursory use of EDIT-80, the 
first four chapters of this document contain all 
the information necessary to complete a fairly 
extensive editing session. The remaining chapters 
describe the enhancements to EDIT-80 that provide 
the user with more sophisticated techniques. 

1.2 Running EDIT-80 

To run EDIT-80, type and enter 

EDIT 

V at TRSDOS command level. EDIT-80 will ask for the 

filename by typing 

FILE: 

Enter the name of your file. Use TRSDOS filename 
format for the filename: 

filename [/extension] [.password] [:drive#] 

If the filename refers to a file that already 
exists, type the filename followed by <enter>, and 
EDIT-80 will read in the file. If the file does 
not have line numbers, EDIT-80 will append them, 
beginning with line number 100 and incrementing by 
100. After EDIT-80 prints 

Version x.x 

Copyright 1977,78 (c) by Microsoft 

Created: xxxx 

xxxx Bytes free 



it is at commmand level, as indicated by the * 
prompt. All commands to EDIT-80 are entered after 
the * prompt. 

If the filename refers to a new file to be created, 
type the filename followed by the <break> key. 
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EDIT-80 will return the message 

Creating 

Versi on x.x 

Copyright 1977,78 (c) by Microsoft 

Created; xxxx 
xxxx Bytes tree 
* 

Next enter the command I (see Section 2.1 for a 

further description of the I command). EDIT 80 

will type the first line number, 00100, followed by 
a tab. 

*I 
00100 



Now vou are ready to enter the first line of your 
Now you are * lsta of up to 255 characters and 

is terminated by <enter>. After every line 
entered, EDIT-80 will type the next line number 
incrementing by 100. This is the permanent 
increment." (There are various commands that will 
change the permanent increment - see Chapter £.) 
Line numbers 00000 through 99999 are available for 
use in your EDIT-80 file. 



NOTE 



Microsoft products such as TRS-80 FORTRAN 
and MACRO-80 all support input files which 
include EDIT-80 line numbers. 

If a typing error is made while entering or editing 
a linef use the Delete key «- ) to delete the 
incorrect character (s) . If, while typing a line, 
you wish to erase the entire line and start over, 
type shift < — . 

When you wish to stop entering lines and return to 
command level, type the <break> key after the next 
available line number. 

1-3 Ending the Editing Session 

To exit EDIT-80, enter the Exit command: 

*E 

The Exit command writes the edited file to disk 
under the filename that was used to create the 
file. Subsequent editing sessions with that riie 
require that a filename be specified with the Exit 
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{ command. See Section 6.1. 

To exit EDIT-80 without writing the edited file to 
disk, enter the Quit command: 

IP 

After execution of a Quit command, all the changes 
entered during the editing session are lost. 

1 - 4 Line Numbers and Ranges 

Most commands to EDIT-80 require a reference to a 
line number or a range of line numbers. A line 
number is specified by using the number itself (it 
is not necessary to type the leading zeros) , or one 
of three special characters that EDIT-80 recognizes 
as line numbers. These special characters are: 

. (period) refers to the current line 
A (up arrow) refers to the first line 
* (asterisk) refers to the last line 

Ranges may be specified in one of two ways: 

1. With a colon. The designation 

200:1000 

means all lines from line number 200 to line 
number 1000, inclusive. If lines 200 and 1000 
do not exist, the range will begin with the 
first line number greater than 200 and end with 
the last line number less than 1000. 

2. With an exclamation point. The designation 

20013 

means the range of three lines that starts with 

line 200. If line 200 does not exist, 20013 

means the range of three lines that starts with 
the first line after 200. 

Here are some examples of line and range 
specifications (shown here with the Print command) : 

P.: 2000 Prints the range that begins with 
the current line and ends with 
line 2000. 

P500 Prints line 500. 

P. Prints the current line. 



^ 
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P.! 15 Prints the range that begins at 
the current line and ends after 
the next 15 lines. 

PA: 1500 Prints the range that begins with 
the first line and ends with 
line 1500. 

PA:* Prints the entire file. 

See Appendix C for more examples of range 
specification. 



1 . 5 Format Notation 

Throughout this document, generalized formats of 
EDIT-80 commands are given to guide the user. 
These formats employ the following conventions: 

1. Items in square brackets are optional. 

2. Items in capital letters must be entered as 
shown . 

3. Items in lower case letters enclosed in angle 
brackets are to be supplied by the user: 

<position> supply any line number (up 
to five digits) or "."/'A" 
or "*" 

<range> supply any <position> or 
any <range> 

<range> = <position>:<position> 

or 
<position>!<number> 

<inc> supply a non-zero integer 
to be used as an increment 
between line numbers 

<filename> supply any legal TRSDOS 
filename as described 
in Section 1 . 2 

4. Punctuation must be included where shown. 

5. Items separated by a vertical line are mutually 
exclusive. Choose one. 

6. <break> refers to the break key and is echoed 
as $. If you see a $ in a format notation, it 
refers to the break key. 



I 
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7. In any command format, spaces and tabs are 
insignificant, except within a line number or a 
filename. 

8. Underlined items are typed by EDIT-80. 
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CHAPTER 2 
Beginning Interline Editing 



Editing a file by printing, inserting, deleting and 
replacing entire lines or groups of lines is termed 
interline editing. This section describes the commands used 
to perform these functions. 



2. 1 Insert Command 

The Insert command is used to insert lines of text 
into the file. EDIT-80 types each line number for 
you during insert mode. The format of the Insert 
command is: 

I[<position>[,<inc> | ;<inc>]] 

Insertion of lines begins at <position> and 
continues until <break> is typed or until the 
available space at that point in the file is 
depleted. (In either case, EDIT-80 returns to 
command level.) 

If no <inc> is included with the command, the 
default is the permanent increment. ,<inc> 
specifies a new increment that is then established 
as the permanent increment. ;<inc> specifies a 
temporary increment for use with the current 
command, but does not change the permanent 
increment. 

If no argument is supplied with the Insert command 
(Kenter>) , insertion resumes where the last insert 
command was terminated, using the last temporary 
increment. If only <position> is supplied 
(Kposition><enter>) , the permanent increment is 
used. 

EDIT-80 will not allow insertion where a line 
already exists. If <position> is a line number 
that already exists, the command Kposition> will 
add the permanent increment (or the temporary 
increment, if one was specified) to <position> and 
allow insertion at line number <position>+<inc>. 
If line <position>+<inc> already exists, or if line 
numbers exist between <position> _ and 
<position>+<inc>, an error message will be printed. 

The line feed (\lo key may be used to start a new 
physical line without starting a new logical line, 
thus providing compatibility with Microsoft BASIC 
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source files. 

Here is an example using the Insert command: 

*I7740,10 

07740 K=K+ 1 

(T7750 GO TO 400 

07760 $ 



Note that the insertion is terminated with <break>. 
The <break> key may be typed at the end of the last 
line inserted (instead of <enter>) or at the 
beginning of the next line. A line is not saved if 
<break> is the first key typed on that line. 



2.2 Delete Command 

The Delete command removes a line or range of lines 
from the file. The format of the command is: 

D<range> 

After a Delete command is executed, the current 
line (".") is set to the first line of the deleted 
range. 

Examples of the Delete Command: 

D7000 delete line 7000 

D. delete the current line 

D200:900 delete lines 200 through 900 

D2000:* delete all lines from line 
2000 through the last line 

2.3 Replace Command 

The Replace command combines the effects of the 
Delete and Insert commands. The format of the 
command is: 

R<range>[,<inc> | ;<inc>] 

The Replace command deletes all of the lines in 
<range>, then allows the user to enter new text as 
if an Insert command had been issued. (EDIT-80 
types the line numbers.) 

The options for selecting the increment between 
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line numbers are the same as those for the Insert 
command (see Section 2.1), 

Here is an example using the Replace command: 

*R500:600;50 

00500 DO 80 1=1,7 

00550 Y(I)=ALOG(Y(D) 

00600 80 CONTINUE 

* 

In the above example, the lines in the range 500 to 
600 were deleted and replaced by three new lines 
(500, 550 and 600), using a temporary increment of 
50. Insertion terminated automatically because 
there was not enough room for EDIT-80 to create 
line 650. 

2.4 Print Command 

The Print command prints lines at the terminal. 
The format of the command is: 

P<range> 

Examples of the Print command: 

P.:700 print all lines from the 

current line through line 700 

P800:* print all lines from line 800 
through the end of the file 

Typing <line feed> (I) at command level will cause 
the line after the current line to be printed. 
Typing <break> at command level will cause the line 
before the current line to be printed. Typing 
p5enter> will cause the next 20 lines to be 
printed. 

2. 5 List Command 

The List command 

L<range> 

is the same as the Print command, except the output 
goes to the line printer. 



( 
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2.6 Number Command 

The Number command renumbers lines of text. You 
may wish to renumber lines to "make room" for an 
insertion, or just to organize the line numbers in 
a file. The format of the Number command is 

N[<start>] [,<inc> | ; <inc>] [=<range>] 

where : 

1. <start> is the first number of the new 
sequence. If <start> is omitted but <range> is 
included, <start> is set to the first line of 
<range>. If <start> and <range> are omitted, 
but <inc> is included, <start> is set to <mc>. 
If <start> is omitted and <inc> is included and 
<range> specifies only a page number ( e -9-' 
=/2) , <start> is also set to <mc> on that 
page. If <start>, <range> and <inc> are 
omitted, <start> is set to the permanent 
increment. 

2. <inc> is the increment between line numbers in 
the new sequence. The options for selection of 
the increment are the same as those described 
for the Insert command (see Section 2.1). 

3. <range> is the range of line numbers to be 
renumbered. If <range> is omitted, the entire 
file is renumbered. 

If the current line is renumbered, "." is reset to 
the same physical line. 

If a Number command would result in line numbers 
being placed out of sequence, or if EDIT-80 cannot 
fit all the lines using the given increment, an 
"Out of order" error message is returned. 

Due to EDIT-80 's internal memory requirements for 
executing a Number command, an attempt to renumber 
a very large file may result in an "Insufficient 
memory" error. If this situation arises, renumber 
a smaller portion of the file, write it to disk, 
renumber another portion, and so on. (See Write 
Command, Section 6.3.) 

Examples of the Number command: 

N7000;100=200:1000 Lines 200 through 1000 will 

be renumbered to begin at 
line 7000 and increment by 
100. 
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N, 1 0=400 :* Lines 400 through the end 

will be renumbered to begin 
with 400 and increment by 10. 

N9000= 10000:* Using the permanent increment 

lines 10000 through the end 
will be renumbered to begin 
at 9000. 

N,100 Renumber the whole file using 

increment 100. 

N,5=2350I10 This command could be used to 

make room for an insert by 
compactifying the ten lines 
starting with 2 350. 
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CHAPTER 3 
Intraline Editing - Alter Mode 



The interline editing commands discussed thus far let you 
edit by inserting, deleting or replacing entire lines. Of 
course many editing situations require changes to an 
existing line but not necessarily retyping of the line. 
Editing a line without retyping it is called intraline 
editing, and it is done in Alter mode. 



3. 1 Alter Command 

The Alter command is used to enter Alter mode. The 
format of the command is: 

A<range> 

In Alter mode, EDIT-80 types the line number of the 
line to be altered and waits for an Alter mode 
subcommand. 



3.2 Alter Mode Subcommands 

Alter mode subcommands are used to move the cursor; 
search for text; or insert, delete or replace text 
within a line. The subcommands are not echoed on 
the terminal. 

Many of the Alter mode subcommands may be preceded 
by an integer, causing the command to be executed 
that number of times. (When no integer is 
specified, the default is always 1.) In many cases, 
the entire command may also be prefaced with a 
minus sign (-) which changes the normal direction 
of the command's action. For example: 

D deletes the next character 

6D deletes the next 6 characters 

-D deletes the last character 

-12D deletes the last 12 characters 
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Each Alter mode subcommand is described below. A 
summary of the subcommands is given in Appendix B. 



NOTE 

In the following descriptions, $ represents 
<break>, <ch> represents any character, 
<text> represents a string of characters of 
arbitrary length and i represents any 
integer. 



3. 3 Cursor Position 

The following commands or terminal keys are used to 
change the position of the cursor in the line. The 
location of the cursor is called the "current 
position. " 

<space> spaces over characters. i<space> moves the 
cursor i characters to the right. 
-i<space> moves the cursor i characters to 
the left. Characters are printed as you 
space over them. 

— > moves the cursor to the end of the line. 
If preceded by a minus sign, moves the 
cursor to the beginning of the line. 

L prints the remainder of the line and posi- 
tions the cursor at the beginning of the 
line. Proceed with the next Alter mode 
subcommand. 

P prints the remainder of the line and recy- 
cles the cursor to the current position. 
Proceed with the next Alter mode 
subcommand. 

W moves to the beginning of the next word. A 
word is defined as a contiguous collection 
of letters, numbers, ".", "$", or "%". iW 
advances the cursor over the next i words. 
-iW moves the cursor back through i words 
to the left. 



3.4 Insert Text 



inserts text. Ktext>$ inserts the given 
text beginning at the current position. 
Note that the text must be followed by a 
<break> or by <enter>. 
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B inserts spaces (blanks) at the current 
position. The B command may be preceded 
by an integer to insert that many spaces. 
Spaces are inserted to the right of the 
cursor only. 

G inserts characters. iG<ch> inserts i 
copies of <ch>. 

X extends a line. The X subcommand types 
the remainder of the line, goes into 
insert mode and lets you insert text at 
the end of the line. The -X subcommand 
moves to the beginning of the line and 
goes into insert mode. (Don't forget to 
end your insertion with <break> or 
<enter>. ) 



3.5 Delete Text 

D deletes the character at the current posi- 
tion. iD deletes i characters beginning 
at the current position. -iD deletes i 
characters to the left of the current 
position. Deleted characters are 
surrounded by double exclamation points. 

< — The back-arrow key may also be used to de- 
lete characters. The character 
immediately to the left of the current 
position is deleted. i<back-arrow> is 
equivalent to -iD. 

H deletes (hacks) the remainder of the line 
to the right of the cursor (or to the left. 
of the cursor if -H is typed) and enters 
the insert mode. Text insertion proceeds 
as if an I command had been typed. 

K deletes (kills) characters. K<ch> deletes 
all characters up to but not including 
<ch>. iK<ch> deletes all characters up to 
the ith occurrence of <ch>. -iK<ch> 
deletes all characters up to and including 
the ith previous occurrence of <ch>. If 
<ch> is not found, the command is not 
executed. 
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deletes (obliterates) text. 0<text>$ de- 
letes all text up to but not including the 
next occurrence of <text>. iO<text>$ 
deletes all text up to the ith occurrence 
of <text>. -iO<text>$ deletes all 
characters up to and including the ith 
previous occurrence of <text>. 

deletes (truncates) the remainder of the 

line to the right of the cursor (or to the 

left of the cursor if -T is typed) and 
exits Alter mode. 

deletes (zaps) words. iZ deletes the next 
i words. -iZ deletes words to the left of 
the cursor. 



3.6 Replace Text 



replaces text. iR<text>$ deletes the next 
i characters and replaces them with 
<text>. -iR<text>$ replaces text to the 
left of the cursor. The deleted 
characters are echoed between double 
exclamation points. 

changes characters one character at a 
time. C<ch> changes the next character to 
<ch>. Only the new character is echoed. 
iC may be followed by i characters to 
change that many characters; or it may be 
followed by fewer than i characters and 
terminated with <break>, in which case the 
remaining characters will not be changed. 
-iC does an i<back arrow> and then an iC. 
The i<6ack arrow> is echoed between 
exclamation points. 



3.7 Find Text 



searches for a character. S<ch> searches 
for the next occurrence of <ch> after the 
current position and positions the cursor 
before the character. iS<ch> searches for 
the ith occurrence of <ch>. -S<ch> and 
-iS<ch> search for the (ith) previous 
occurrence of <ch> and position the cursor 
immediately before it. The character at 
the cursor position is not included in the 
search. If <ch> is not found, the command 
is ignored. 
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finds text. F<text>$ finds the next occur- 
rence of <text> and positions the cursor 
at the beginning of the string. iF<text>$ 
finds the ith occurrence of <text>. 
-F<text>$ and -iF<text>$ find the (ith) 
previous occurrence of <text> and position 
the cursor before it. 



3. 8 Ending and Restarting Alter Mode 

<cr> carriage return. Prints the remainder of 
the line, enters the changes and concludes 
altering of that line. 

A same as carriage return. 

E enters the changes and concludes altering 
of that line, but does not print the 
remainder of the line. 

N restores the original line (changes are 
not saved) and either moves to the next 
line (if an A<range> command is still in 
progress) , or returns to command level. 

Q restores the original line (changes are 
not saved), exits (quits) Alter mode, and 
returns to command level. 

Shift < — Restores the original line, stays in Alter 
mode and repositions the cursor at the 
beginning of the line. Echoes as AY. 



3.9 Extend Command 

The Extend command is issued at command level and 
is used to extend lines. The format of the command 
is 

X<range> 

The effect of the X command is equivalent to typing 
an A command, followed by an X subcommand. After 
entering an X command, proceed by typing the text 
to be inserted at the end of the line. Don't 
forget you are now in Alter mode and may use any of 
the Alter mode subcommands, once <break> has been 
typed. 

The Extend command is particularly useful, for 
placing comments in assembly language programs. 
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CHAPTER 4 
Find and Substitute Commands 



When it is necessary to change a certain portion of text, it 
is not always immediately known where that text is located 
in the file. Even with a listing of the file on hand, it is 
a tiresome task to scan the listing to find the line number 
of a particular item that must be changed. 

The EDIT-80 Find and Substitute commands allow the user to 
quickly locate text and make necessary changes. 



4. 1 Find Command 

The Find command locates a given string of text in 
the file and types the line(s) containing that 
string. The format of the command is: 



F [<range>] [ ,<limit>] <enter> 



$<string>$ 



where $ represents the escape key and <limit> is 
the number of lines containing <string> to be 
found. A limit of zero will find all occurrences 
of <string>. The following rules apply to the 
format of the Find command: 

1. If $<string>$ is omitted, the last string given 
in a Find command is used. 

2. If <limit> is omitted and $<string>$ is 
included, <limit> is assumed to be 1. 

3. If <limit> and $<string>$ are omitted, the 
previous limit is assumed. 

4. If <range> is omitted and $<string>$ is 
included, the entire range from the previous 
Find command is used. 

5. If <range> and $<string>$ are omitted, the 
search for the previous string continues from 
the line where the last occurrence was found. 

If the search is unsuccessful, an error message is 
printed. 



e 
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Here is a sample editing 

*FA:*$WHI(D$ 
Q~11Q0 WHI(I)=Q 

(J1400 
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using Find: 



session 

Find the first line that 
contains WHI (I). Prints line 
1100. Find the next °^' £| intS 
line 1400. Caught a mistake 
in this line. Alter it. 



*F,2$WLO(I)$ 
01500 • 



*F.:*$AVG$ 
Search fails 



"*F$MEANE. 

3700 MEAN=SUM/40_ 



*F,0 
04200 
06700 " 
'*A420F 
04200 



IF (P . GT . MEAN)M^M+1 



Kina u»c first two lines in the 
ii^that contain _WLO (I (range 



Find the 



is still 
1200 and 



*) 

1500. 



Prints lines 
Alter line 1500. 



Find the first line in the file 
that contains AVG. There aren't 
any! Try finding MEAN instead. 
Dvin+-s line 3700. 
finS all other lines contain- 
ing MEAN. (Search begins at the 
line after line 3700. Finds 
two more (4200 and 6700). 
Alter line 4200, etc. 
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4.2 Substitute Command 

The Substitute command locates a given string, 
replaces it with a new string and types the new 
line(s). The format of the command is: 



S[<range>] [,<limit>] <enter> 



$<old string>$<new string>$ 



where $ represents <break>, and <limit> is the 
number of lines in which <old string> is to be 
replaced by <new string>. A limit of zero will 
replace all occurrences of <old string> with <new 
string>. <new string> may be a null string. The 
following rules apply to the format of the 
Substitute command: 

1. If $<old string>$<new string>$ are omitted, the 
strings given in the last Substitute command 
are used. 

2. If <limit> is omitted and $<old string>$<new 
string>$ are included, <limit> is assumed to be 
zero. 

3. If <limit> and $<old string>$<new string>$ are 
omitted, the previous limit is assumed. 

4. If <range> is omitted and $<old string>$<new 
string>$ are included, the entire range from 
the previous Substitute command is used. 

5. If <range> and $<old string>$<new string>$ are 
omitted, substitution continues from where the 
last substitution left off. 

If no occurrence of <old string> is found, an error 
message is printed. 

Example: 

*SAs5000$ALPHA$BETA$ From the first line 

00950 BETA( m=ABS(1.-LST(K)) to line 5000, replace 

OTTTO WR ITE (6,460) I'ETA(lO all occurrences of 

04100"" IF (BETA (iQ.LT.O) GOTO 9000 ALPHA with BETA. 
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CHAPTER 5 
Pages 



It is possible to divide an EDIT-80 file into sections 
called pages, which are separated by page marks. The first 
page of a file is always page 1, and EDIT-80 always enters 
command level on page 1 of a multiple-page _ file. Each 
subsequent page begins with a page mark and is numbered 
sequentially. On any given page, the complete range of line 
numbers (00000 to 99999 or any portion thereof) may be used. 

If EDIT-80 encounters a form feed while reading in a file, 
it will enter a page mark at that point in the file. If 
EDIT-80 encounters a line number that is less than the 
previous line number, it will automatically insert a page 
mark so that proper line number sequence may be maintained. 
When EDIT-80 writes a file out to disk, a form feed is 
output with each page mark. Then, when the file is listed, 
each new page of the file starts on a new physical page. 

5.1 Specifying Page Numbers 

In a single-page file, only a line number is needed 
to indicate <position>. In a multiple-page file, 
EDIT-80 must know the page number as well as the 
line number to determine a <position>. That is, 
<position> is indicated by 

><line> [/<page>] 

where 

<line> is " . " , "A", "*" or a number of up to five 
digits. 

<page> is ".", "A", "*" or a number of up to five 
digits. When specifying a page, the characters 
".", "A" and "*" refer to the current page, the 
first page and the last page, respectively. If 
<page> is omitted, the current page is assumed. 

Consequently, in a multiple-page file a <range>, 
which may be indicated by 

<position> : <position> 

or 
<position> ! <number> 

may also contain page numbers. If the page number 
is omitted from the first line number in the range, 
it is assumed to be the current page. If the page 
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number is omitted from the second line number in 
the range, it is assumed to be on the same page as 
the first line number in the range. 

Here are some examples of line numbers and ranges 
that include page number specification: 

100/2;*/* Line 100 on page 2 through 

the last line on the last page 

100/2:* Line 100 on page 2 through 

the end of that page 

100:*/5 Line 100 on the current page 

through the last line on 
page 5 

100/* Line 100 on the last page 

100/.:*/3 Line 100 on the current page 

through the last line on 
page 3 

See Appendix C for more examples of range 
specification. 

5.2 Inserting Page Marks 

Page marks may be inserted in the file at the 
discretion of" the user. To insert a page mark, use 
the Mark command. The format is: 

M<position> 

The page mark is inserted immediately after 
<position>. <position> must exist or an error 
message. will be printed. 

The current line reference (".") is retained after 
a Mark command is executed. That is, if <position> 
is before ".", then "." will be moved to the next 
page and will still point to the same physical 
line. 



5.3 Deleting Page Marks 

Page marks are deleted with the K (Kill) command. 
The format of the command is: 

K/<page> 

The K command deletes the page mark after <page>. 
For example, in a four-page file, K/2 would delete 
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the second page mark (the page mark that started 
page 3), and the pages would then be numbered 1, 2, 
and 3. The last line number on <page> must be 
lower than the first line number on <page>+1 before 
a K/<page> command can be executed. 



5. 4 Begin Command 



Use the Begin command to return to the beginning of 
a page. The format of the Begin command is: 

B [/<page>] 

If <page> is omitted, the B command returns to the 
beginning of page one. 



5.5 Other Commands and Page Marks 

1. A Delete command that crosses over a page 
boundary will delete all lines in the range, 
but will not delete the page mark. 

2. A Print command that moves off the current page 
will print the new page number prior to 
printing the first line specified in the 
command. 

3. When output is being done with the List 
command, a form feed will be printed with each 
page mark, and the page number will be printed 
on each page. 

4. A range specified with an exclamation point may 
cross a page boundary. 

5. If the range specified in a Number command 
crosses page boundaries, numbering will start 
over on each new page; the first line number 
will equal the increment. Consequently, in the 
Number command, <start> and the first line of 
<range> must be on the same page. 
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CHAPTER 6 
Exiting EDIT-80 



Section 1.3 introduced the Exit and Quit commands for 
exiting EDIT-80. These two commands will be described more 
completely in this chapter. An additional command, the 
Write command, will also be presented. 



6. 1 Exit Command 

The Exit command is used to write the file to disk 
and return to TRSDOS. The format of the command 
is: 

E[<filename>] [-<switch>] 

The edited file is saved on the disk under 
<filename>. When exiting a new file for the first 
time, <filename> may be omitted. (In which case, 
the opening filename is assigned.) Otherwise, a new 
filename is required for each Exit. The previous 
file serves as a back-up. 

The optional <switch> controls the format of the 
output. (See Section 6.5.) 

6 . 2 Quit Command " 

The Quit command is used to return to TRSDOS 
without writing the edited file to disk. To Quit 
editing, simply enter: 

Q 

After a Quit command, all changes entered during 
the editing session are lost. 



6. 3 Write Command 

The Write command writes the edited text to disk 
and then returns to EDIT-80 command level. It does 
not exit the editor, and the current position in 
the file is not changed. The format of the command 
is : 

W[<filename>] [-<switch>] 

A filename is not required in the first Write of a 
new file. A filename is required, however, in all 
subsequent Write and Exit commands. 
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The optional <switch> controls the format of the 
output. (See Section 6.5.) 



6„4 Index Files 

When reading in a file to be edited, EDIT-80 
generates information it needs about each block of 
the disk file. With a small file, this information 
is generated in a few seconds, each time the file 
is read in. However, with larger files (5K or 
more) , the time lag required to read in the file 
becomes significant. Thus, when EDIT-80 saves a 
file of 42 or more records on the disk, it also 
saves a small file, separate from the text file, 
containing the required information about the text 
file. 

This small file is called the index file, and it 
can be read faster than the text file. EDIT-80 
saves the index file under a filename that is the 
same as the text filename (passwords not included) , 
with a Z preceding the first two letters of the 
extension. For example, if the file is called 
FOO/MAC.SAM, the index file is called FOO/ZMA. 

When EDIT-80 is asked to edit a file, it first 
checks for an index file. If an index file exists, 
EDIT-80 reads the index file instead of the text 
file. Care must be taken if the text file is 
modified by another editor or changed and saved in 
BASIC. The user' must then delete the index "file 
prior to editing the text file again with EDIT-80. 
If the index file is not deleted, EDIT-80 will have 
meaningless information about the text file. 



6.5 Parameters 

When reading in a file, EDIT-80 expects it to be in 
its own representation. If the file appears to be 
in another representation, EDIT-80 will add line 
numbers and try to convert the file to EDIT-80 
standard format. There are, however, several other 
representations that EDIT-80 accepts, if the proper 
switch is appended to the input filename. Switches 
are always preceded by a^dash (-) : 

filename [/ext] [.password] [:drive#] [-switch] 

For example: FOO/BAS. SAM- BASIC 
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6.5.1 BASIC Switch 

If the BASIC switch is appended to the input 
filename, EDIT-80 will read the file using the 
following algorithm: 

1 . All leading spaces and tabs are removed from 
each line. 

2. The first non-blank character must be a digit. 

3. From 1 to 5 leading digits are converted to a 
line number. More than 5 leading digits 
constitutes a fatal error. 

4. A tab is inserted if the first non-digit is not 
a space or a tab. If the first non-digit is a 
space, it is replaced by a tab. If the first 
non-digit is a tab, it is left alone. 

5. On output, if UNSEQ (see Section 6.5.2) has 
been selected, leading zeros in the line number 
are suppressed and the tab is converted to a 
space. 

Because BASIC uses line numbers to control the 
sequence of program execution, BASIC users should 
beware of renumbering with the N command. 
Microsoft BASIC will ignore page marks from the 
EDIT-80 file, so a BASIC file may have multiple 
pages. Insure, however, that no line number 
appears more than once in the program. 



6.5.2 SEQ and UNSEQ Switches 

If the SEQ switch is appended to the input 
filename, EDIT-80 will use the same algorithm to 
interpret the text file as with the BASIC switch. 
However, when the file is output, it will be in 
standard EDIT-80 format, unless the UNSEQ switch is 
appended to the output filename. 

The UNSEQ switch on input tells EDIT-80 to append 
its own line numbers to the incoming file, 
regardless of what it looks like. This switch must 
be used if the incoming file has digits at the 
beginning of lines with high bits on that are not 
to be interpreted as line numbers. 

On output, the UNSEQ switch must be specified (if 
it hasn't been already) to output a non-standard 
file. That is, if BASIC is specified on input and 
UNSEQ is specified on output, the file will be 
output in BASIC format. If BASIC was not specified 
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on input and UNSEQ is specified on output, the file 
will be output with no line numbers and no trailing 
tab. If the UNSEQ switch was specified on input 
and the user wishes to output a standard file, the 
SEQ switch on output will override the UNSEQ 
switch. 



C 



(. 
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APPENDIX A 
Alphabetic Summary of Commands 



Command 



Alter 



Begin 



Delete 



Exit 



Find 



Insert 



Kill 



List 



Mark 



Number 



Print 



Format and Description 

A<range> 

Enters Alter mode. 

B[<page>] 

Moves to the beginning of <page>. 

Default is page 1 . 

D<range> 
Deletes lines. 

E[<filename>] [-<switch] 
Writes the edited text to disk 
and exits the editor. 



Quit 



F[<range>] [,<limit>] <enter> I $<string>$ 
Finds occurrences of <string>. 

I [<position>] [ ,<inc> j ;<inc>] 
Inserts lines beginning at <position> 
using increment <inc>. With no 
argument, continues with previous 
Insert command. 

K/<page> 

Deletes the page mark at the end of 

<page>. 

L<range> 

Prints lines at the line printer. 

M<position> 

Inserts a page mark after <position>. 

N[<start>] [,<inc> | ;<inc>] [=<range>] 
Renumbers the lines in <range> so 
they begin at <start> and increment 
by <inc>. 

P [<range>] 

Prints lines at the terminal. 
With no argument, prints the 
next 20 lines. 

Q 

Exits the editor without writing 

the edited text to disk. 



Page 
15 

25 

11 

6, 26 

20 



10 



24 



12 



24 



13 



12 



6, 26 
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Replace R<range> [ ,<inc> | ;<inc>] 

Replaces line(s) using increment 
<inc>. 



18 



Substitute S[<range>] [ ,<limit>] <enter> 



$<old string>$<new string>$ 



Write 



extend 



Replaces <old string> with <new strxng>. 

W[<filename>] [<~<switch>] 

Writes the edited text to disk but 

does not exit the editor. 

X<range> 

Allows insertion of text at the 

end of a line. 



22 
26 

19 



Microsoft EDIT-80 User's Guide 



Page 32 



APPENDIX B 
Alphabetic Summary of Alter Mode Subcommands 



Command Format 
A A 



B 


[i]B 


C 


[-] [i]C<ch>[. 


D 


[-] [iJD 


E 


E 



F 
G 
H 

I 
K 



N 







.<ch>] 



[-] [i]F$<text>$ 

[i]G<ch> 

[-]H<text>$ 

Ktext>$ 
[-] [i]K<ch> 



N 



[-] [i]0<text>$ 



Q 



Q 



Action 

Prints the remainder of the 
line, enters the changes 
and concludes altering of 
that line 

Inserts spaces 

Replaces characters 

Deletes characters 

Enters the changes and 
concludes altering of that 
line 

Finds <text> 

Inserts i copies of <ch> 

Deletes the remainder of 
the line and enters the 
insert mode 

Inserts <text> 

Deletes all characters up 
to <ch> 

Positions the cursor at the 

beginning of the line 

Restores the original line 
and either moves to the 
next line (if an A<range> 
command is still in 
progress) or returns to 
command level 

Deletes all characters up 
to <text> 

Recycles the cursor to the 
current position 

Exits Alter mode and 
restores the original line 
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R 

S 

T 



[-] [i]R<text>$ 

[-] [i]S<ch> 
[~]T 



w 


[-] [i]W 


X 


[-]x 


z 


[-] [i]Z 



[-] 



[-] [i]<space> 



<enter> 



Shift <- 



Replaces i characters with 

<text> 

Finds <ch> 

Deletes the remainder of 
the line and concludes 
altering of the line 

Moves the cursor over words 

Extends the line 

Deletes words 

Moves the cursor to the end 
of the line 

Deletes characters 

Moves the cursor over 
characters 

Prints the remainder of the 
line, enters changes and 
concludes altering of that 
line 

Restores the original line, 
stays in Alter mode and 
repositions the cursor .at 
the beginning of the line. 
Echoes as ^Y. 
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APPENDIX C 
Summary of Notation 

The notation used in this document may be defined as follows: 
<line> = <number> .A * 



<page> = <number> | . | A | * 

<position> = <line>[/<page>] 

<range> = <position> [ :<position> | !<number>] 

where: 
<number> = <digit> | <number><digit> 
<digit> = | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 

Shorthand Notation for Ranges 

The following "shorthand" forms of range specifications may be used 
with EDIT-80 commands. 

Shorthand Equivalent Ran 9 e . 



Notation 



To Specified 



/<page> A/<page>: */<page> All of <page>. 

/< P age1>:/<page2> A/<page1> : */<page2> The first line on < P age1> 
r through the last line on 

<page2>. 

A/1:*/* The entire file. 

<position>: <position>:*/* <position> through the end 

of the file. e.g. , 
.: is the same as ./.:*/* 

•<position> A/1:<position> The first line in the file 

through <position>. e.g., 
s. is the same as A/1:./. 
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APPENDIX D 
EDIT-80 Special Characters 



<break> Aborts the command in progress 

and returns to EDIT-80 
command level. 

— > Types a tab. 

Shift <- Erases the line being typed 

and lets you start over. 
When used in Alter mode, Shift< — 
restores the original line, 
stays in Alter mode and 
repositions the cursor at the 
beginning of the line. 

Control characters are typed by holding down the shift 
key, the down-arrow (|) key and the correct alpha key 
at the same time. 



Control 



Control S 



Suspends/resumes output (at 
the terminal or line printer) 
from an EDIT-80 command. 

Halts/resumes execution of 
an EDIT-80 command. 



v 
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APPENDIX E 
Error Messages 



Fatal Errors 

Disk I/O errors are fatal. The corresponding TRSDOS error 
message will be printed. 

Any TRSDOS system error message is fatal. 

Illegal line format 

Occurs when EDIT-80 finds a line with strange contents or a 
strange line number. This should not normally occur when 
editing a file created by EDIT-80. It is usually caused by 
reading files not meant for editing, such as binary files. 

Edit Error Messages 

Illegal command 

Tells the user a nonexistent or ill-formed command was 

typed . 

Insufficient memory available 

Occurs when the user has made enough changes to the file to 
have exhausted EDIT-80 ' s memory area. This should only 
happen when a large file has many changes or when large 
portions of code are being inserted or renumbered. " A W 
command should be done to compress memory. 

No string given 

Tells the user the F or S command was given without a search 
string. This usually happens when using the F or S command 
with no arguments prior to issuing an F or S command with 
arguments, or when an <escape> without a search string is 
typed following the range. 

No such line (s) 

This message is issued if a command references a line or 
range which does not exist. Usually occurs when the proper 
page number is omitted from the line or range. 

Line too long 

This message is issued when the user attempts to enter a 

line longer than 255 characters. This may happen when the 

line is read or as a result of a command which alters the 

line. 

Out of order 

Indicates that the line numbers in the file would not be in 
ascending order if the command were to be executed. This 
frequently happens when trying to insert where there is not 
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enough room or trying to delete a page mark. 

Search fails 

An informative message that tells the user a search was 

unsuccessful. 

Wrap around 

This message is printed whenever a line greater than 99999 

would be generated. 

File Errors 

File already exists 

Issued if the user tries to give the name of an existing 
file to a new file, or tries to rename a file using the name 
of an existing file in an E or W command. 

File not found 

IssuedTf the file specified in a command could not be 

found. 

Illegal file specification 

Informs the user that the command string contains an illegal 

character of some kind. 
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APPENDIX F 
Output File Format 



Compilers and assemblers should ignore the line numbers and 
page marks included in EDIT-80 output files (except when 
included in listing files). Microsoft TRS-80 FORTRAN and 
MACRO- 80 both do so. 

A line number consists of five decimal digits followed by a 
tab character. All six bytes have the high order bit (bit 
7) equal to one. It is not recommended that EDIT-80 files 
be listed with the TRSDOS LIST command. Graphics characters 
may appear in the line numbers. Use EDIT- 80' s Print command 
instead. 

When writing a file with -BASIC set, the line numbers have 
the high order bits equal to zero. Each line number is 
followed by a space that has the high order bit equal to 
zero. 

A page mark is a form feed character with the high order bit 
equal to one. 
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